"""Controllers of the application.

There are two types of controllers:
  - usual ones
  - REST Controller styled on the Atom Publishing Protocol
  
TTo properly map REST controller, ensure your config/routing.py file has
 a resource setup (ie: for the controller feedbacks):
  map.resource('feedback', 'feedbacks')
  
REST controllers define several standard methods.
Here is an example for a 'feedbacks' controller:

  def index(self, format='html'):
    # GET /feedbacks: All items in the collection.
    # url('feedbacks')
    pass

  def create(self, environ):
    # POST /feedbacks: Create a new item.
    # url('feedbacks')
    pass

  def new(self, environ, format='html'):
    # GET /feedbacks/new: Form to create a new item.
    # url('new_feedback')
    # TODO: use referer also
    pass

  def update(self, id):
    # PUT /feedbacks/id: Update an existing item.
    # Forms posted to this method should contain a hidden field:
    #  <input type="hidden" name="_method" value="PUT" />
    # Or using helpers:
    #  h.form(h.url_for('feedback', id=ID),
    #       method='put')
    # url('feedback', id=ID)
    pass

  def delete(self, id):
    # DELETE /feedbacks/id: Delete an existing item.
    # Forms posted to this method should contain a hidden field:
    #  <input type="hidden" name="_method" value="DELETE" />
    # Or using helpers:
    #  h.form(h.url_for('feedback', id=ID),
    #       method='delete')
    # url('feedback', id=ID)
    pass

  def show(self, id, format='html'):
    # GET /feedbacks/id: Show a specific item.
    # url('feedback', id=ID)
    pass

  def edit(self, id, format='html'):
    # GET /feedbacks/id/edit: Form to edit an existing item.
    # url('edit_feedback', id=ID)
    pass

"""
